home *** CD-ROM | disk | FTP | other *** search
/ Aminet 13 / Aminet 13 - August 1996.iso / Aminet / mus / play / DeliTracker225.lha / DeliTracker_II / Bonus / DeliAY.lzx / DeliAY / DeliAY.readme next >
Text File  |  1990-11-30  |  5KB  |  164 lines
  1. Short: DeliAY 0.14 for DeliTracker 2.14+
  2. Type: mus/play
  3. Uploader: rak@dolni.ms.mff.cuni.cz (Patrik Rak)
  4. Author: rak@dolni.ms.mff.cuni.cz (Patrik Rak)
  5.  
  6. [excuse my terrible English...]
  7.  
  8. Prologue
  9. ========
  10.  
  11. Welcome to this pre-release of DeliAY - AY emulator for DeliTracker 2.07
  12. and above.
  13.  
  14. Some time ago I have released my FXS - Frantisek Fuka's AY tunes demo
  15. program.
  16.  
  17. Quite a lot of people reacted and asked me if I am not going to write some
  18. kind of generous AY Emulator. Especially Peter Kunath (author of
  19. DeliTracker) seemed to be quite interested in and asked me to write an AY
  20. DeliPlayer. So, here you can see the result of our several discussions and
  21. source exchanges...
  22.  
  23. Installation
  24. ============
  25.  
  26. So, how to use this archive?
  27.  
  28. Well, at first, copy DeliPlayers/DeliAY to wherever your DeliPlayers are.
  29. This is the main AY emulator interface between DT and AY Players.
  30.  
  31. Then copy whole AYPlayers/ drawer in the same dir where your DT2 program is
  32. installed (sorry, for now, PROGDIR:AYPlayers/ is used as look up path
  33. for AYPlayers, surely will be configurable later). So far, only ZXAYAMAD
  34. (Amadeus - MC68000 rewrite of its z80 original, is used for those amad.#?
  35. songs) and ZXAYEMUL (Z80 Emul Player - used for running original z80 code,
  36. (like PlaySID does) for those emul.#? songs) are available.
  37.  
  38. Now you are ready to go. Just launch your DeliTracker2 and then try to load
  39. some tunes from the Songs/ directory. Frantisek_Fuka/ dir contains all
  40. songs which you have probably already heared in FXS, directory Others
  41. contains some other songs which I wrote in the past while playing with
  42. Amadeus (terrible, but better than nothing :-) plus few famous tunes for
  43. the emulator which I converted in few minutes. Directory Incoming contains
  44. songs which I didn't took too much care of so far... People have a lot of
  45. ripped tunes, and it takes just a moment to convert it for the Emul Player,
  46. so you can expect great tunes very soon...
  47.  
  48. So, that's all for those standard users. Developers read the dev/dev.doc!
  49.  
  50. To Do
  51. =====
  52.  
  53. - GUI which will allow you to configure the AY Players path, channel
  54.   assignement, show additional Tune/AYPlayer info, etc.
  55.  
  56. - Check out the White Noise generation formulae. So far I was unable to
  57.   find out some exact AY WN frequency information. Anyone knows more?
  58.   I think it sounds quite OK, but... ;-)
  59.  
  60. - Finally implement the Envelopes. Indeed, this is the most important one.
  61.   But I thought I can release this version without that, because a) Amadeus
  62.   doesn't use them, so you can listen to the songs sooner, b) you can write
  63.   AY Players sooner.
  64.  
  65. - Write more AY players - SoundTracker, VooDoo, SQ Tracker, perhaps WHAM
  66.   128 too, etc.
  67.  
  68. Thanks must go to
  69. =================
  70.  
  71. Peter Kunath        for his big help with this DeliPlayer,
  72.             and his work on the GUI (sorry for that GUI again)
  73.  
  74. FrantiÓek Fuka        for his tunes and the Amadeus, and for ripping
  75.             AY tunes in the past
  76.  
  77. TomÁÓ PÁrtl        for giving me his VMP cassette and other help
  78.  
  79. Alastair Booker        for sending me the tunes, although I was unable
  80.             to assemble them on my Amiga so far
  81.  
  82. and all those who have contacted me and encouraged me to do this...
  83.  
  84. What's new
  85. ==========
  86.  
  87. This is new release of DeliAY. The DeliPlayer itself didn't changed to
  88. much, except that it now finally displays subsong names (which was not
  89. possible before, until I forced Peter Kunath to implement this in DT :-)
  90.  
  91. The really new part are the ZXAYSTRC and ZXAYST11 AYPlayers, which allow
  92. replaying tunes from the famous (Polish, I think) SoundTracker 1.1 for ZX
  93. Spectrum. The first one is the version which plays tunes compiled by my
  94. compiler/compressor, so I do not suppose that it will be very useful for
  95. you; the latter is for the original file format produced by the ST11. Here
  96. is the header which you can use to convert your ST songs to format playable
  97. by ZXAYST11 player:
  98.  
  99.     incdir    'includes:'
  100.     include    misc/AYPlayer.i
  101.     incdir    ''
  102. b
  103.     AYMODHEADER    ST11
  104.     dc.w    0        ;no internal player
  105.     dc.w    0        ;unknown creator
  106.     dc.w    0        ;no misc info
  107.     dc.b    1-1        ;how many songs
  108.     dc.b    0        ;which should start first
  109.     dc.w    songdata-*
  110.  
  111. songdata    dc.w    name1-*
  112.     dc.w    data1-*
  113.  
  114. name1    dc.b    'Some ST11 Song',0
  115.     even
  116.     
  117. data1    dc.b    0,1,2,3        ;channel assignement
  118.     dc.w    0        ;fade offset
  119.     dc.b    0,50        ;fade len
  120.     incbin    dh2:deliay/tmp/yourdata.dat
  121. e
  122.  
  123. After compiling save binary from b to e. See dev/ZXAYST11.S for more
  124. detailed info about the header format.
  125.  
  126.  
  127. The other new thing is the huge amount of songs for EMUL and ST11 players.
  128.  
  129. For the songs for the EMUL player we all must thank to Alastair Booker (big
  130. applause!!!), who encourages me every once in a while and who spent lot
  131. of time ripping these tunes. Thank him.
  132.  
  133. The ST songs I have got from Slavo Labsky (BusySoft), but I have put them
  134. in incomming so far since I just appended simple ST11 header and didn't
  135. took much care of them.
  136.  
  137. Contact addresses
  138. =================
  139.  
  140. Send all new AY Players, AY tunes, bug reports, questions or suggestions to
  141. the following addresses:
  142.  
  143. Internet: prak3264@barbora.mff.cuni.cz (school)
  144. FIDO: 2:420/24.7 (home)
  145. FIDO via Inet Gate: p7.f24.n420.z2@fidonet.org
  146.  
  147. or (in worst case)
  148.  
  149. Patrik Rak
  150. Fantova 1796/4
  151. Praha 5
  152. 150 00
  153. Czech Republic
  154.  
  155. Also, if you think I did good job, you can send me any amount of money you
  156. want (well, you can send them even if you do not think so :-). Or at least
  157. send me a mail that you appreciate it. The more people will react, the more
  158. work I will put in PlayAY in the future...
  159.  
  160.  
  161. That's all.
  162.  
  163. Patrik
  164.